// ==========================================================================
// GFast自动生成api操作代码。
// 生成日期：2024-04-26 15:54:41
// 生成路径: api/v1/business/ticket_remain.go
// 生成人：周志雄
// desc:节目票剩余相关参数
// company:云南奇讯科技有限公司
// ==========================================================================


package business


import (    
    "github.com/gogf/gf/v2/frame/g"    
    commonApi "github.com/tiger1103/gfast/v3/api/v1/common"    
    "github.com/tiger1103/gfast/v3/internal/app/business/model"
)
// TicketRemainSearchReq 分页请求参数
type TicketRemainSearchReq struct {
    g.Meta   `path:"/list" tags:"节目票剩余" method:"get" summary:"节目票剩余列表"`    
    Id  string `p:"id"` //主键ID    
    PerformanceId  string `p:"performanceId" v:"performanceId@integer#演出节目ID需为整数"` //演出节目ID    
    TicketType  string `p:"ticketType"` //票类型(1甲、2乙、3丙)    
    RemainNum  string `p:"remainNum" v:"remainNum@integer#票的剩余数量需为整数"` //票的剩余数量    
    CreatedAt  string `p:"createdAt" v:"createdAt@datetime#创建时间需为YYYY-MM-DD hh:mm:ss格式"` //创建时间    
    commonApi.PageReq
    commonApi.Author
}
// TicketRemainSearchRes 列表返回结果
type TicketRemainSearchRes struct {
    g.Meta `mime:"application/json"`
    commonApi.ListRes
    List []*model.TicketRemainListRes `json:"list"`
}
// TicketRemainAddReq 添加操作请求参数
type TicketRemainAddReq struct {
    g.Meta   `path:"/add" tags:"节目票剩余" method:"post" summary:"节目票剩余添加"`
    commonApi.Author    
    Id    int  `p:"id" v:"required#主键ID不能为空"`    
    PerformanceId  int   `p:"performanceId" `    
    TicketType  string   `p:"ticketType" `    
    RemainNum  int   `p:"remainNum" `    
}
// TicketRemainAddRes 添加操作返回结果
type TicketRemainAddRes  struct {
    commonApi.EmptyRes
}
// TicketRemainEditReq 修改操作请求参数
type TicketRemainEditReq struct {
    g.Meta   `path:"/edit" tags:"节目票剩余" method:"put" summary:"节目票剩余修改"`
    commonApi.Author
    Id    int  `p:"id" v:"required#主键ID不能为空"`    
    PerformanceId  int `p:"performanceId" `    
    TicketType  string `p:"ticketType" `    
    RemainNum  int `p:"remainNum" `    
}
// TicketRemainEditRes 修改操作返回结果
type TicketRemainEditRes  struct {
    commonApi.EmptyRes
}
// TicketRemainGetReq 获取一条数据请求
type TicketRemainGetReq struct {
    g.Meta `path:"/get" tags:"节目票剩余" method:"get" summary:"获取节目票剩余信息"`
    commonApi.Author
    Id    int `p:"id" v:"required#主键必须"` //通过主键获取
}
// TicketRemainGetRes 获取一条数据结果
type TicketRemainGetRes struct {
    g.Meta `mime:"application/json"`
    *model.TicketRemainInfoRes
}
// TicketRemainDeleteReq 删除数据请求
type TicketRemainDeleteReq struct {
    g.Meta `path:"/delete" tags:"节目票剩余" method:"delete" summary:"删除节目票剩余"`
    commonApi.Author
    Ids    []int `p:"ids" v:"required#主键必须"` //通过主键删除
}
// TicketRemainDeleteRes 删除数据返回
type TicketRemainDeleteRes struct {
    commonApi.EmptyRes
}
